home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / telix212.arc / TLXDIR.DOC < prev    next >
Text File  |  1986-10-09  |  7KB  |  127 lines
  1.                                    TLXDIR
  2.                            Telix Directory Command
  3.                                by Bill de Haan
  4.  
  5.     MagicSoft has recently  released a useful  little program called  TT, which
  6. calculates the time  it would take  to transmit specified  files. Although this
  7. utility is  very useful,  it does not account  for Telix's transmission speeds,
  8. which are faster than  the standard  transmit times.  Also, it  only allows for
  9. Xmodem protocol transmissions, so there is  no allowance for such things as  1K
  10. blocks under Ymodem, nor Kermit file transfers. In addition, MagicSoft put a 12
  11. line  header  at  the  top  of  the  printout, which removes the possibility of
  12. putting the output through any time of filter, such as the SORT utility in DOS.
  13.  
  14.     The  program  TLXDIR  performs  in  the  same  fashion as the DOS directory
  15. command,  as  well  as  putting  the  Telix  transmission times in the right 40
  16. columns. It supports all of the protocols Telix does, and may be used with  any
  17. DOS filter, such as SORT  or MORE. I also added  a total function, so that  you
  18. can calculate  not only  the individual  transmit times,  but the  times for an
  19. entire group of files. In order to make the output as clean as possible,  there
  20. is no inteactive user interface. All options and files must be specified on the
  21. command line. A TLXDIR command can take either of the forms below:
  22.  
  23. a)  tlxdir fspec1 [fspec2...fspecN] [-baud] [-protocol] [-s] [-p] [-v] [-?]
  24. b)  tlxdir -size filesize1 [filesize2...filesizeX] [-baud] [-protocol]
  25.  
  26. The options are as follows:
  27.     fspec       file specification. Wildcards (* and ?) are allowed. You may
  28.                 also specify  drive and/or path identifiers,  although these
  29.                 will not be displayed on the printout.
  30.     -?          a help message showing these options is displayed.
  31.     -baud       baud rate, which must be 300, 1200, 2400, 4800, 9600 or 19200.
  32.     -h          same as -?
  33.     -p          pause when screen is full, like dir /p
  34.     -protocol   -x or -r (Xmodem) -y (Ymodem) -t (Telink) -k (Kermit)
  35.     -s          print out the sum total transmit time for all files.
  36.     -v          version number is displayed, and program terminates.
  37.     -size       don't read files, just calculate from the filesize given.
  38.  
  39. NOTE:   Although all examples in this documentation file use the  Unix
  40.         - option format, TLXDIR  will accept the  DOS standard / as an
  41.         option card identifier as well. The commands "TLXDIR /300" and
  42.         "TLXDIR -300" are identical.  I prefer the Unix  standard, but
  43.         both are supported equally.
  44.  
  45.     Both -r  and -x  support the  Xmodem protocol.  The -r  option supports the
  46. relaxed version  of xmodem.  At the  moment, these  two give  the same transmit
  47. times, so they are effectively the same. If no command line options are  given,
  48. TLXDIR  assumes  1200  baud,  Xmodem  protocol,  and  all  files in the current
  49. directory. A typical run of TLXDIR looks like this:
  50.  
  51. C:\TELIX>tlxdir *.exe -y -s
  52. CL       EXE    27044   2-18-85   1:16a     3 minutes, 58 seconds.
  53. IPL      EXE    15906   7-03-86   1:42a     2 minutes, 20 seconds.
  54. LOGOFF   EXE    11788   9-26-86   4:46a     1 minutes, 44 seconds.
  55. LOGON    EXE    11788   9-26-86   6:11a     1 minutes, 44 seconds.
  56. MSC      EXE    27100   2-18-85   1:16a     3 minutes, 59 seconds.
  57. P0       EXE    32182   2-21-85   3:12a     4 minutes, 43 seconds.
  58. P1       EXE    74770   2-21-85   3:27a    10 minutes, 58 seconds.
  59. P2       EXE   103094   7-03-86   9:11a    15 minutes,  7 seconds.
  60. P3       EXE    69412   2-14-85   5:37a    10 minutes, 11 seconds.
  61. SNOOZE   EXE     1928   8-07-86   3:20a     0 minutes, 17 seconds.
  62. TLXDIR   EXE    16616   9-27-86   0:15a     2 minutes, 27 seconds.
  63. --- Total of 11 files, 391628 bytes.
  64. --- Total Ymodem transmission time at 1200 baud is: 57 minutes, 28 seconds,
  65.  
  66. C:\TELIX>_
  67.  
  68.  
  69.  
  70.     You may specify as many files on the command line as you want. For example,
  71. "TLXDIR *.EXE *.COM *.BAT -k -9600" is perfectly valid, and will calculate  the
  72. time it would take Telix to transmit to send all executable, command, and batch
  73. files in the current directory at 9600 baud, using Kermit protocol.
  74.  
  75.     The second  form of  the TLXDIR  command is  used to calculate transmission
  76. times from file sizes entered on the command line. This is useful when you want
  77. to  calculate  the  transmission  time  for  files  on the host system. This is
  78. especially true on Fido  systems, where the Telix  times are usually less  than
  79. the Fido calculations. The run below is a typical TLXDIR of this format:
  80.  
  81. C:\TELIX>tlxdir -size 11788 8615 11788 1817
  82. File size    11788,   2 minutes,  9 seconds.
  83. File size     8615,   1 minutes, 35 seconds.
  84. File size    11788,   2 minutes,  9 seconds.
  85. File size     1817,   0 minutes, 20 seconds.
  86. --- Total of 4 files, 34008 bytes.
  87. --- Total Xmodem transmission time at 1200 baud is: 6 minutes, 13 seconds.
  88.  
  89. C:\TELIX>_
  90.  
  91.     Note that with this  format, you will always  get the total time  and size.
  92. The -size option was added so that users could get a quick tally of a group  of
  93. files. As a  result, there is  no support for  the pause, since  I doubt anyone
  94. would enter more  than 20 file  sizes on the  command line. If  anyone actually
  95. wants the pause option installed, let me know.
  96.  
  97.     It is extremely important that you remember to put an option indicator tag,
  98. either the minus sign (-) or forward slash character (/) in front of a protocol
  99. character, a baud rate, or any option. If a command line element does not  have
  100. a leading option tag, it is treated as a file name.
  101.  
  102.     Although I like the total time to  be listed, TLXDIR was designed to be  as
  103. compatable with the standard dos dir command as possible, so the default is  no
  104. totals. Likewise, the pause option defaults to off, as well.
  105.  
  106.     Please be  aware that  these time  estimations are  just that: estimations.
  107. Although I use the same algorithm as Telix does, it cannot of course take  into
  108. account line noise or other  interferences that effect transmission time.  Also
  109. be aware that  these times do  not take into  account the faster  throughput at
  110. higher speeds. Since I  only have a 1200  baud modem, I cannot  do timing tests
  111. for the higher speeds, although I am told that they are reasonably accurate, if
  112. not perfect.
  113.  
  114.     Please send  any comments  about this  program to  me on  the PC Pub BBS in
  115. Toronto, phone number  (416) 487-2889. Address  it to "Bill de_Haan" in  either
  116. the public message area, or the Telix response area.
  117.  
  118.     This program was written in Microsoft C v3.0. This program source code  and
  119. documentation remain my  personal property. There  are no restrictions  on  its
  120. use, except for corporate environments with more than one copy in use, who must
  121. contact me. In addition, it is not to be modified by the user, or sold with  or
  122. as  part  of  any  hardware  of  software  package. The documentation file MUST
  123. accompany the program.
  124.  
  125.                                  Bill de Haan
  126.  
  127.